home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / jet114.zip / JETMAIL.FIX < prev    next >
Text File  |  1992-02-25  |  14KB  |  295 lines
  1. JetMail Diagnostic Reference
  2. ----------------------------
  3.  
  4. If JetMail shuts down due to a fatal error, it may be as simple as a
  5. missing Spitfire system file, JetMail system file, or a problem in the
  6. DOS environment.  If the fatal/shutdown error message refers to one of
  7. the system files, please check your configuration.  If JetMail has an
  8. error otherwise, the error value should correspond to one of the items
  9. below.
  10.  
  11.   0  Error 0
  12.   1  Invalid function number
  13.   2  File not found
  14.   3  Path not found
  15.   7  Memory blocks destroyed
  16.   9  Invalid memory block address
  17.  10  Invalid environment
  18.  11  Invalid format
  19.  12  Invalid access code
  20.  13  Invalid data
  21.  15  Invalid drive specified
  22.  16  Attempt to remove CurDir
  23.  17  Not same device
  24.  18  No more files
  25.  
  26.   2  No such file or directory
  27.   4  Too many open files
  28.   5  Permission denied
  29.   6  Bad file number
  30.   8  Not enough core
  31.  15  No such device
  32.  19  Invalid argument
  33.  20  Arg list too long
  34.  21  Exec format error
  35.  22  Cross-device link
  36.  33  Math argument
  37.  34  Result too large
  38.  35  File already exists
  39.  
  40. Should JetMail return with one of the following error messages, here
  41. are some common diagnosis:
  42.  
  43. ERROR: Unable to open file!
  44.         One of the basic files needed for JetMail operation is missing.
  45.         This could be the JETMENU.BBS/.CLR files, if no menu is showing
  46.         up in JetMail.  Make sure the JETMENU.BBS file exists in the
  47.         JetMail home directory.
  48.  
  49. * Error opening system file SFSYSTEM.DAT.
  50.         JetMail is unable to open the SFSYSTEM.DAT file.  Is another
  51.         node on the network editing this file?
  52.  
  53. * Memory allocation error.
  54.         Not enough memory to run JetMail.  If running under DesqView,
  55.         try to allocate more memory to the node.  If that doesn't work,
  56.         then it may be an idiosyncracy with your DOS not allocating
  57.         memory in a manner compatible with JetMail.  Refer to next error
  58.         message for another remedy.
  59.  
  60. * Tried to allocate <x> bytes, with <y> available.
  61.         If <y> is greater than <x>, or <y> is negative, chances are that
  62.         JetMail has a memory management problem with your DOS.  This was
  63.         discovered in a pre-release version of JetMail, which somehow
  64.         triggered this idiosyncracy.  By default, JetMail will allocate
  65.         a 7000-byte buffer for JetMail to import/export messages.  This
  66.         will cover a message over 700 lines long (even though Spitfire
  67.         limits messages to 99 lines, it might be possible in the future
  68.         to allow longer message and/or a Fidonet mail tosser might allow
  69.         more than 99 lines of text).  An undocumented function has been
  70.         added in JetMail in case you need to use it, which may remedy
  71.         this problem.  If you want to allocate more (or less) memory for
  72.         this buffer, simply enter the BUFFER=mmmmm parameter in
  73.         JetMail's .CNF configuration file, where mmmmm is the size of
  74.         the buffer.  This is a 'tinker' parameter, so try some different
  75.         buffer sizes (small, and overly large) to see if JetMail can be
  76.         adjusted to work with your system.
  77.  
  78. * Error building CONTROL.DAT file.
  79.         Common error message when JetMail is unable to access the
  80.         temporary work directory.
  81.  
  82. * Error locating user in Spitfire database.
  83.         JetMail needs to find the Spitfire user record number to
  84.         properly access the SFMSG<x>.LMR file, which contains the users'
  85.         last message read pointers for each conference.  JetMail uses
  86.         these message pointers to scan for new messages. JetMail
  87.         searches the SFUSERS.PTR file for the user named in DOOR.SYS.
  88.         You may have a corrupt DOOR.SYS, or a non-existing user using
  89.         JetMail.
  90.  
  91. * User name mismatched in SFUSERS.DAT.
  92.         This may indicate a corrupt DOOR.SYS or Spitfire users file.
  93.         This error only occurs when using the user record number to
  94.         access the SFUSERS.DAT results in a mismatched between the name
  95.         in the Spitfire database and in the DOOR.SYS.  Possibly solution
  96.         is to regenerate the AUTOJET.SYS if you are using Auto-Pilot
  97.         with a local copy of DOOR.SYS in the JetMail home directory,
  98.         which has a user record number out of sync due to a newly packed
  99.         user database.
  100.  
  101. * Error opening system file SFUSERS.DAT.
  102.         Is the user file being edited by another node?
  103.  
  104. * Error creating MESSAGE.DAT file.
  105.         JetMail writes all the new messages scanned into a file named
  106.         MESSAGES.DAT, in the QWK format.  If JetMail is unable to create
  107.         this file, it may have problems with disk space in the JetMail
  108.         work directory.
  109.  
  110. * Error building .PNT pointers file.
  111.         Unable to build the .PNT file, perhaps because of disk space.
  112.  
  113. * Error reading .PNT pointers file.
  114.         Uploaded pointers file was probably corrupt.
  115.  
  116. * Error copying .QWK packet to local destination.
  117.         JetMail was unable to copy the file to the destination, probably
  118.         disk space error.
  119.  
  120. * REP packet not found.
  121.         JetMail detected a successful transfer (denoted by deleted
  122.         XFER_ERR.JET), but isn't able to find a .REP in the JetMail
  123.         temporary work directory.  Be sure to receive the .REP file into
  124.         the JetMail temporary work directory (or the .REP file gets
  125.         copied to the JetMail work directory).
  126.  
  127. * Error copying .REP packet from local directory.
  128.         No .REP packet was found in the specified directory during local
  129.         JetMail use.
  130.  
  131. * Error transferring file
  132.         JetMail returns this error whenever it find XFER_ERR.JET still
  133.         remaining in the Spitfire Externals path if using
  134.         XFERTYPE=SFEXT, or in the JetMail work directory when using
  135.         XFERTYPE=JET.  If the file transfer was successful, be sure you
  136.         delete the XFER_ERR.JET so JetMail can detect the successful
  137.         transfer.  Consult your DOS manual if needed; make sure the DOS
  138.         batch file is properly deleting XFER_ERR.JET upon successful
  139.         transfers.  Use the sample batch files in JETXFER.ZIP and set
  140.         XFERTYPE=JET in the JetMail .CNF, if you are unable to correct
  141.         the error, and be sure DSZ.COM or DSZ.EXE is in the DOS path.
  142.  
  143. * QWK not found.  Unable to run compression utility?
  144.         JetMail shells out to compress the contents of a QWK packet,
  145.         based on the PACK<x>QWK command lines specified in the JetMail
  146.         .CNF configuration, where <x> can be 1 to 3.  After returning
  147.         from the shell, JetMail finds no .QWK generated.  The selected
  148.         compression utility is needing more memory than what is
  149.         available after JetMail is loaded.  You may need to run JetMail
  150.         from the Spitfire Doors menu instead of as a menu extension.
  151.         [The command line of the PACK1QWK is passed two parameters by
  152.         JetMail, the first parameter is path and filename of the .QWK
  153.         packet to generate, and the second parameter is *.* of the
  154.         JetMail work directory.  If your compression utility is unable
  155.         to use these parameters, please contact author.]
  156.  
  157. * Error opening LMR file for Conf # <x>, or
  158. * Error reading LMR file for Conf # <x>
  159.         Spitfire automatically generates SFMSG<x>.LMR files when new
  160.         conferences are added.  If a LMR file is doesn't exist for
  161.         conference numbered <x>, check your Spitfire's message path to
  162.         make sure the conference message files are intact.  If you just
  163.         added some conferences to Spitfire, login to Spitfire first,
  164.         before running JetMail, to have Spitfire generate the LMR files
  165.         appropriately.
  166.  
  167. * Error reading user's last msg read pointer, or
  168. * Error writing user's last msg read pointer.
  169.         JetMail uses Spitfire's user record number to access the
  170.         corresponding last message read pointer for the user.  The
  171.         SFMSG<x>.LMR file may have been generated, but it wasn't
  172.         adjusted in size for the new JetMail user.
  173.  
  174. * Error building index file for .QWK packet, or
  175. * Error writing to index file.
  176.         JetMail builds <x>.NDX files for the QWK packet, which are index
  177.         files used by the offline mail reader.  The indices point to
  178.         where the messages for each conference are; actual messages are
  179.         stored in MESSAGES.DAT.  May be a disk space problem.
  180.  
  181. * Error building Personal msgs index file, or
  182. * Error writing to Personal msgs index file.
  183.         JetMail builds a PERSONAL.NDX file for the QWK packet, which are
  184.         index files used by the offline mail reader to locate messages
  185.         addressed to the user.  If there are no personal messages, the
  186.         .QWK will not have a PERSONAL.NDX.  May be a disk space problem.
  187.  
  188. * Error building MESSAGES.DAT file.
  189.         Disk space problem?
  190.  
  191. * PNT packet not found.
  192.         When using JetMail's "P" command to upload a pointers file, the
  193.         transfer may have been aborted, or during local use, the .PNT
  194.         file was not found in the designated directory.
  195.  
  196. * Error opening replies file.
  197.         When a .REP packet is received, JetMail will try to process that
  198.         packet for message replies to post into the Spitfire
  199.         conferences.  The .MSG file may simply be corrupt, but more
  200.         likely the compression utility used to make the .REP packet
  201.         doesn't match the user's currently configured compression
  202.         utility in JetMail.
  203.  
  204. * Error opening message base
  205.         JetMail tried to read Spitfire's conference message bases and
  206.         encountered an error.  Make sure your SFMSG<x>.* files are
  207.         intact in the Spitfire messages path.
  208.  
  209. Detected Truncated Message.
  210.         While JetMail is processing a .REP packet, it may encounter a
  211.         message reply that is corrupt.  Check the offline reader to make
  212.         sure the .REP packet generated is intact.
  213.  
  214. * Error opening JetMail configuration file.
  215.         JetMail is unable to open the default JETMAIL.CNF in the JetMail
  216.         home directory (which should be the current directory, when
  217.         JetMail is first started).  This error may also occur if the
  218.         .CNF file specified on the JetMail command line doesn't exist.
  219.         Check your batch file to make sure JetMail knows which
  220.         configuration file it is trying to read.
  221.  
  222. * Unable to find JetMail users file.
  223.         When a new user enters JetMail, JetMail records the users name
  224.         in the JetMail users database file named USERS.JET in the
  225.         JetMail home directory.  Before JetMail returns to Spitfire,
  226.         JetMail tries to write the user's JetMail configuration to the
  227.         users database.  However, if it can't find the user's name in
  228.         the users database, JetMail gets confused - after all, it was
  229.         supposed to have written the users name to the users database
  230.         when the door was first opened.
  231.  
  232. * Unable to create JetMail users file, or
  233. * Error creating JetMail users file.
  234.         Disk space error?  JetMail creates a USERS.JET user database
  235.         file to keep track of user's JetMail configuration.
  236.  
  237. * Unable to find protocols list
  238.         JetMail uses SFEXTDN.BBS as its transfer protocols if XFERTYPE=
  239.         parameter is set to SFEXT in the JetMail .CNF configuration
  240.         file, or if XFERTYPE= parameter is not specified, JetMail also
  241.         defaults to using SFEXTDN.BBS, and the SFEXT<x>.BAT files.  If
  242.         XFERTYPE=JET is set in the JetMail .CNF file, JetMail looks for
  243.         JETXFER.LST in the JetMail home directory.
  244.  
  245. * JetMail is for use with SPITFIRE 3.x only!
  246.         JetMail only works with Spitfire 3.x versions.  JetMail does
  247.         use the DOOR.SYS which Spitfire generates.
  248.  
  249. * Error making temporary JetMail work directory.
  250.         When no WORKDIR= is specified in the JetMail configuration file,
  251.         JetMail makes its own temporary work directory off of the
  252.         JetMail home directory.  However, an error was encountered
  253.         trying to make this directory, usually named TMP1.$$$ or
  254.         something like that.  Please use the WORKDIR= parameter in the
  255.         JetMail .CNF configuration file and specify a temporary work
  256.         directory for proper JetMail operation.
  257.  
  258. Unable to find SFFILES.BBS for File Area # <x>
  259.         When the user is configured for scanning new files in JetMail,
  260.         JetMail looks for the SFFILES.BBS in the file directories and
  261.         looks for new files.  This error means that JetMail couldn't
  262.         find a directory file SFFILES.BBS for the designated File Area.
  263.         Check your path specification in SFFAREA.DAT.
  264.  
  265. - Error locating SPITFIRE system file.  Notify Sysop.
  266.         JetMail uses a number of Spitfire system files, including
  267.         SFMCONF.DAT, SFFAREA.DAT, SFNODE.DAT, SFSYSTEM.DAT, SFUSERS.DAT.
  268.         Make sure the paths specified in SFNODE.DAT are correct for the
  269.         current node.
  270.  
  271. * Error removing temporary work directory.
  272.         When no WORKDIR= is specified in the JetMail configuration file,
  273.         JetMail makes its own temporary work directory off of the JetMail
  274.         home directory.  JetMail will automatically remove this
  275.         directory upon exiting the door; however, an error was
  276.         encountered trying to remove this directory, usually named
  277.         TMP1.$$$ or something like that.  You may safely delete the
  278.         files in this directory and the directory once JetMail is done.
  279.  
  280. Invalid argument: Invalid argument
  281.  
  282.         This error is only shown locally.  JetMail encountered a DOS
  283.         error when trying to determine the file date on the bulletins
  284.         and/or newsletter, or determining file size prior to .QWK
  285.         transfer.  JetMail can encounter this error in an unexpected
  286.         DOS environment, or conflict with TSR (memory resident)
  287.         utilities.  Try to not load unnecessary memory resident
  288.         utilities and this should clear up.
  289.  
  290. Error creating New Files list.
  291.         Disk space problem?  When the user is configured in JetMail to
  292.         scan for new files, JetMail will generate a text file named
  293.         NEWFILES.DAT in the JetMail temporary work directory.
  294.  
  295.